<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="Content-Style-Type" content="text/css">
<title></title>
<meta name="Generator" content="Cocoa HTML Writer">
<meta name="CocoaVersion" content="949.46">
<style type="text/css">
p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Helvetica}
p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Helvetica; min-height: 17.0px}
p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 10.0px Monaco}
p.p6 {margin: 0.0px 0.0px 0.0px 0.0px; font: 10.0px Monaco; min-height: 14.0px}
span.s1 {font: 18.0px Helvetica}
span.s2 {text-decoration: underline}
span.Apple-tab-span {white-space:pre}
</style>
</head>
<body>
<p class="p1"><span class="s1"><b>AtsFile<span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span></b></span><b>For working with ATS file data</b></p>
<p class="p2"><br></p>
<p class="p2"><br></p>
<p class="p3"><b>Working with ATS files</b></p>
<p class="p2"><br></p>
<p class="p3">ATS (Analysis-Transformation-Synthesis) files are analysis files created using Oscar DeLiscia, Juan Pampin and Pete Moss's <b>atsa </b>command-line analysis tool (available at <span class="s2">http://www.dxarts.washington.edu/ats</span>). The analysis of the sound first attemps to track and record frequency data into sinusoidal partials.<span class="Apple-converted-space">  </span>Then, any sound that couldn't be analyzed into partial information is analyzed as noise information. The information can then be tranformed and resynthesized using this information.</p>
<p class="p2"><br></p>
<p class="p3">Once installed, type <b>atsa</b> at the command line to see flag options and usage.</p>
<p class="p2"><br></p>
<p class="p3">An example from within the SuperCollider_f directory:</p>
<p class="p2"><br></p>
<p class="p3"><span class="Apple-tab-span">	</span>atsa sounds/a11wlk01.wav<span class="Apple-converted-space">  </span>sounds/a11wlk01.ats -H5000</p>
<p class="p2"><span class="Apple-tab-span">	</span></p>
<p class="p3">-H5000 limits the analysis to frequencies below 5kHz.</p>
<p class="p2"><br></p>
<p class="p1"><b>Class Methods</b></p>
<p class="p4"><br></p>
<p class="p3"><b>Loading an ATS file with AtsFile</b></p>
<p class="p2"><br></p>
<p class="p3"><b>*new(path, server) </b>- load an ATS file into memory at path with buffer number bufnum.<span class="Apple-converted-space">  </span><b>server </b>defaults to Server.default.<span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
<p class="p5"><span class="Apple-tab-span">	</span>a = AtsFile.new("sounds/a11wlk01.ats");</p>
<p class="p6"><span class="Apple-tab-span">	</span></p>
<p class="p1"><b>Instance Methods</b></p>
<p class="p2"><br></p>
<p class="p3"><b>load(buffer) </b>- loads the information of the ATS file into a buffer for use by the AtsSynth UGens. If buffer is nil, one will be allocated for you. Only for real-time usage.</p>
<p class="p2"><br></p>
<p class="p5"><span class="Apple-tab-span">	</span>a.load;</p>
<p class="p6"><span class="Apple-tab-span">	</span></p>
<p class="p3"><b>freeBuffer - </b>releases the ATS buffer</p>
<p class="p2"><br></p>
<p class="p3"><b>info</b> - returns info about the ATS object</p>
<p class="p2"><br></p>
<p class="p3"><b>getParFreq(par) </b>- returns an array of frequencies of partial number par (starting with 0) per frame of analysis.</p>
<p class="p2"><br></p>
<p class="p3"><b>getParAmp(par) </b>- returns an array of amplitudes of partial number par (starting with 0) per frame of analysis.</p>
<p class="p2"><br></p>
<p class="p3"><b>getFrameFreq(frame)</b> - returns an array of frequenciesfor a given frame (starting with 0).</p>
<p class="p2"><br></p>
<p class="p3"><b>getFrameAmp(frame)</b> - returns an array of frequenciesfor a given frame (starting with 0).</p>
<p class="p2"><br></p>
<p class="p3"><b>saveForSC(path)</b> - save the ATS file as an AIFF that can be loaded into a buffer (for NRT and fast loading file data in real-time)</p>
<p class="p2"><br></p>
<p class="p2"><span class="Apple-converted-space"> </span></p>
</body>
</html>
